PBDTGetAPPLAsync

PBDTGetAPPLAsync
Header:	Files.h		Carbon status:	Supported

Identifies the application that can open a file with a given creator. This function runs asynchronously.

OSErr PBDTGetAPPLAsync (
    DTPBPtr paramBlock
);

paramBlock: A pointer to a desktop parameter block.

function result: A result code.

DISCUSSION

Clear all fields (other than input fields) in the parameter block that you pass to Desktop Manager functions. The relevant fields of the parameter block for this function are:

ioCompletionOn input, a universal procedure pointer to a completion function. A value of type IOCompletionUPP.
ioResultOn return, the result code. A value of type OSErr.
ioNamePtrOn input, a pointer to the application’s name. A value of type StringPtr.
ioDTRefNumOn input, the desktop database reference number of the specified application. A value of type SInt16.
ioIndexOn input, an index into the application list. A value of type SInt16.
ioTagInfoOn return, the application’s creation date. A value of type SInt32.
ioFileCreatorOn input, the signature of the application. A value of type OSType.
ioAPPLParIDOn return, the application’s parent directory. A value of type SInt32.

For an application in the database specified in ioDTRefNum with the signature specified in ioFileCreator, PBDTGetAPPL returns the filename in ioNamePtr, the parent directory ID in ioAPPLParID, and the creation date in ioTagInfo. A single call, with ioIndex set to 0, finds the application file with the most recent creation date. If you want to retrieve information about all copies of the application with the given signature, start with ioIndex set to 1 and increment until ioResult returns afpItemNotFound; when called multiple times in this fashion, PBDTGetAPPL returns information about all the application’s copies, including the file with the most recent creation date, in arbitrary order.

SPECIAL CONSIDERATIONS

All of the Desktop Manager functions may move or purge memory blocks in the application heap or for some other reason should not be called from within an interrupt. Your application should not call Desktop Manager functions at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.